🌻 Simple AI coding#

The Simple Mode provides a streamlined AI coding workflow inside the normal left pane. It keeps the app structure familiar while reducing clutter.

Quick start: If you have roughly 5–100 pages of text, you can usually **just run everything** and get decent results. Press **Run all** and let it run. You can then go back and adjust the coding (edit links, tweak prompts, re-run specific steps) if you want. For longer texts or high-stakes coding, work incrementally: use the **source limit** in Auto-code (1, 5, 20%, 50%, 100%) and the **Links limit** in Recode to process a sample first, check quality, then scale up.

You can activate it with the "Simple AI coding" switch just below the Sources bar. When you sign up and choose to have AI options switched on and active, Simple AI is turned on by default and you receive 10 free AI credits per month. AI usage consumes credits (see Responses Panel); credits renew monthly and do not roll over. Costs depend on model and workflow, but very roughly you might autocode around 30 pages for about 1 credit.

The Simple Workflow#

When Simple Mode is active:

The workflow is broken down into six straightforward sections:

  1. Run all: Optional one-click runner. Press Run all to run Auto-code, then Revise codebook, then Recode in order.
  2. Runner pre-steps: clears Filter Links, turns filter pipeline on, and (if links already exist) asks once whether to delete all links before starting. You always start fresh.
  3. Recode target suffix: Choose blank (simpler — synthesised labels go straight into cause/effect) or e.g. _recoded (keeps raw labels, writes synthesised to temp columns so you can compare).
  4. Runner uses one top-level confirmation and suppresses the extra per-step confirm dialogs.
  5. Background: Give the AI project context before coding. A status tick indicates whether enough background text is set.
  6. Auto-code: This is where the AI reads your documents and extracts causal links.
  7. You can choose to process a small sample first (e.g., 1 or 5 sources) to test your prompt, or process 100% of them.
  8. The "Skip coded" switch ensures you don't waste time and money re-processing documents that already have links.
  9. Default model in Simple AI is Qwen Flash.
  10. Revise codebook: Once you have some causal links, the AI can review them and suggest a cleaner, more consistent list of factor labels (a "codebook"). The header tick shows whether the Recode codebook area currently contains suggestions.
  11. Includes a Target clusters slider (2 to 50, default 20).
  12. Optional Use automatic pre-clustering switch (default OFF).
  13. When pre-clustering is OFF, the AI tries to find the clusters directly from the factor list using the standard Revise codebook prompt. This prompt supports macro replacement: use [number] (or [cluster_count]) and the slider value is injected at run time.
  14. When pre-clustering is ON, the app first groups factor labels semantically using embeddings, then sends those clustered groups to the AI with a separate labelling prompt plus a Representatives per cluster slider (8 to 20, default 8).
  15. Pre-clustering is more systematic than asking the AI to find all clusters "in its head" from a long raw list. It reduces the black-box / WEIRD-data risk a bit, and may make it easier to preserve more unusual or divergent concepts instead of collapsing them into whatever the model finds most typical.
  16. Default model in Simple AI is Gemini 3 Flash Preview.
  17. Recode: Apply the AI's suggested, cleaned-up labels back to your existing causal links. Paste the codebook (from Revise codebook or your own), add a recode instruction, and run.
  18. The AI returns index mappings (row → codebook item) rather than full label text, reducing tokens and improving reliability.
  19. Default instruction: "For each raw label give me the NUMBER of the best-matching codebook item by meaning. Use 0 when no codebook item fits. Return only codebook label numbers, never words. Never invent labels."
  20. Skip recoded: When on, only processes links that have at least one unrecoded label (cause or effect). Use this when recoding again to focus on remaining work.
  21. Links limit (1, 5, 20%, 50%, 100%): When not 100%, a random sample of links is recoded. Non-sampled links keep their existing recoded values (or stay blank on first run).
  22. The header progress bar is segmented: grey = empty recoded fields, orange = recoded equals original cause/effect, green = recoded non-empty and different.
  23. Default model in Simple AI is Qwen Flash.
  24. Filter links: The normal Filter Links panel appears as the final section of the same accordion, so filtering is part of one continuous simple flow.
  25. After a successful Run all, filters are auto-set to: Temporary Factor Labels (_recoded) → Factor Frequency (top 12) → Link Frequency (top 30).

Run all (Simple AI)#

Background (Simple AI)#

Auto-code (Simple AI)#

Revise codebook (Simple AI)#

Recode (Simple AI)#

Advanced Settings#

Each section header is clickable and opens/collapses its settings panel. Section headers also include contextual Help buttons. The advanced sections are inline (not flyouts), and only one section is expanded at a time.

Inside advanced panels you can: